home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbbsdocs.zip / RBBSDOCS.APU < prev    next >
Text File  |  1990-11-05  |  5KB  |  98 lines
  1.  
  2.  
  3.  
  4.     APPENDIX U -- Recompiling RBBS-PC to Reduce Memory Required             U-1
  5.  
  6.  
  7.     APPENDIX U -- Recompiling RBBS-PC to Reduce Memory Required
  8.     -----------------------------------------------------------
  9.     RBBS-PC is  continually being enhanced with new features.  As new functions
  10.     and   capabilities   are   added,  RBBS-PC's   memory   requirements   grow
  11.     correspondingly.  In order to continue  RBBS-PC's growth and still meet the
  12.     memory constraints imposed  on SysOps with only 640K of  memory who wish to
  13.     run  two copies of  RBBS-PC,  RBBS-PC  source code can  be "mite-sized" and
  14.     recompiled  to fit  within whatever  memory constraints  a SysOp  must deal
  15.     with.
  16.  
  17.     SysOps can apply .MRG files against the  unmodified RBBS-PC source code and
  18.     elect  to eliminate RBBS-PC features not being used and eliminate redundant
  19.     code (typically  the BASIC  source code  that replicates  assembly language
  20.     routines).  RBBS-PC has a companion  "mite-size" set of  files contained in
  21.     the file RBBS-LIT.ZIP.
  22.  
  23.     In  order to recompile and "mite-size" RBBS-PC, within the same environment
  24.     in which the SysOp has successfully recompiled the current release of RBBS-
  25.     PC, the SysOp must also have the following files:
  26.  
  27.     BLED.EXE    --      The Batch  Line EDitor by  Ken Goosens (version  2.2 or
  28.                         greater).
  29.  
  30.     MAKELIT.BAT  --     The BATch  file that  invokes BLED.EXE and  applies the
  31.                         necessary  files to  the unmodified  source code.  This
  32.                         file should  be modified  by putting in  the drive/path
  33.                         for  the original code (the  first parm to  BLED).  The
  34.                         lines  to be modified all begin with "*$", which is the
  35.                         default for  a BLED metacommand.    The lines beginning
  36.                         with "* "  are BLED  comments, which are  ignored in  a
  37.                         merge.
  38.  
  39.     SETLIT.INC   --     The file  through which  the SysOp selects  the RBBS-PC
  40.                         features that are not needed.  The directions for doing
  41.                         this  are  contained within  this  file.  A feature  is
  42.                         typically  removed   by  setting  a   BLED  metacommand
  43.                         variable to "OFF", e.g. BAUD450  to "OFF" to save  code
  44.                         by excluding  the RBBS-PC feature that  allows 300 baud
  45.                         uses to  increase their baud rate to 450 while on-line.
  46.                         To exclude  RBBS-PC LIBRARY  subsystem  set LIBRARY  to
  47.                         "OFF".
  48.  
  49.     RBBSLIT.MRG  --     The fundamental BLED merge for RBBS-PC.BAS
  50.     SUBxLIT.MRG  --     The fundamental BLED merge for various RBBSSUB's.  Each
  51.                         reads  in (includes)  the  file SETLIT.INC  to set  the
  52.                         metavariables used by BLED.  BLED then  uses the values
  53.                         to determines what merges to process.
  54.  
  55.     *.LIT        --     .MRG files that eliminate RBBS-PC features.
  56.  
  57.     The procedure for "mite-size"ing RBBS-PC is as follows:
  58.  
  59.     1.  Select the RBBS-PC features not required for your needs and  modify the
  60.     file SETLIT.INC.
  61.  
  62.     2.  Change MAKELIT.BAT to reflect your PC's subdirectories.
  63.  
  64.     3.  Make sure RBBSSUB1.BAS is in the subdirectory you will run in.
  65.  
  66.  
  67.  
  68.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     U-2
  69.  
  70.  
  71.     4.  Execute the MAKELIT.BAT file.  Do not continue if errors are found.
  72.  
  73.     5.   Recompile the "mite-sized" RBBS-PC source code.  Remember, this "mite-
  74.     sized" source code and the RBBS-PC.EXE file created from it my only be used
  75.     by you and not distributed to others.
  76.  
  77.          Some comments on the various Microsoft QuickBASIC compilers:
  78.               QuickBASIC Version 1.02 produces the smallest code.
  79.               QuickBASIC Version 2.01 produces the next smallest code.
  80.               QuickBASIC Version 3.00 produces the largest code.
  81.               QuickBASIC Version 4.5 produces code smaller than
  82.                     3.00) but is not as reliable
  83.  
  84.          Never LINK with the /E option.
  85.  
  86.     6.  Re-run CONFIG and disable the RBBS-PC features that were deleted in the
  87.     "mite-sized"  version that was created in steps  1 through 5 (i.e. take out
  88.     the "A" command if questionnaires were disabled).
  89.  
  90.     Please realize  that there  is no way  that the "mite-sized"  variations of
  91.     RBBS-PC can  be supported.  The  many different PC configurations  plus the
  92.     multitude  of  combinations   of  RBBS-PC  features  are   what  make  this
  93.     impossible.  However, we will do our best.
  94.  
  95.     Please report any problems with BLED or the *.LIT merges to Ken Goosens via
  96.     his RBBS-PC data number -- (703) 978-6360.
  97.  
  98.